home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / ZCHSS17A.ZIP / SBBS.DOC < prev    next >
Encoding:
Text File  |  1996-03-03  |  11.8 KB  |  230 lines
  1.  
  2.  
  3.  
  4.               Zchess System Configuration Example
  5.     Zchess Version 1.7
  6.     February 11, 1996
  7.  
  8.     This is an example configuration for Zchess specifically for Synchronet
  9.     BBS, DIGITAL DYNAMICS.  If you wish to try Synchronet on a shareware
  10.     basis, you can get a copy from the SBBS support BBSes listed for
  11.     Zchess.  While I do not personally run a BBS, I have set a few of them
  12.     up for the purpose of developing doors.  I have found that Synchronet
  13.     was easy to use by both the sysop and the user.  You can purchase SBBS
  14.     from the following address:
  15.  
  16.     Digital Dynamics
  17.     PO Box 501, Yorba Linda, CA 92686
  18.     (714) 529-6328 Voice
  19.     (714) 529-9721 FAX
  20.  
  21.  
  22.     The Zchess chess door system consists of the following executables:
  23.  
  24.  
  25.        ZCHESS.EXE
  26.        2PGN. EXE
  27.        IMPORT.EXE
  28.        MAINT.EXE
  29.        NETCHESS.EXE
  30.        SETUP.EXE
  31.  
  32.     Of these, a complete SBBS setup will include configuration for
  33.     ZCHESS.EXE for the door, ZCHESS.EXE for a notification logon event,
  34.     MAINT.EXE as a daily or weekly event, and NETCHESS.EXE twice, once for
  35.     OUTgoing messages and once for INcomming messages.    2PGN.EXE is
  36.     executed from either ZCHESS or MAINT, and normally won't have other
  37.     uses.  IMPORT.EXE is intended to be run by the sysop who is attempting
  38.     to make changes to the database.  SETUP.EXE is run by the sysop who is
  39.     making changes to the ZCHESS or NETCHESS configurations.
  40.  
  41.     The following setups represent one way that Zchess can be configured.
  42.     Each system may differ.  These screens were captured from the actual
  43.     configuration of an SBBS setup.
  44.  
  45.     ZCHESS As A Chess Door and It's Your Move Notifier:
  46.  
  47.  
  48. ░░░░╔═════════════════════╗░░░░╔═══════════════════════════════════════════╗░░░
  49. ░░░░║  External Programs  ║░░░░║       Games Online Programs       ║░░░
  50. ░░░░╠═════════════════════╣░░░░╠═══════════════════════════════════════════╣░░░
  51. ░░░░║ │Fixed Events      ║░░░░║ │ZCHESS                   ║░░░
  52. ░░░░║ │Timed Events      ║░░░░║ │ZCHESS NOTIFY                ║░░░
  53. ░░░░║ │Global Swap List   ║░░░░║ │                       ║░░░
  54. ░░░░║ │Ext╔════════════════════╚═══════════════════════════════════════════╝░░░
  55. ░░░░║ │Onl║              Games Program Section             ║░░░░░░░░░
  56. ░░░░╚═════╠══════════════════════════════════════════════════════════╣░░░░░░░░░
  57. ░░░░░░░░░░║ │Name            Games                 ║░░░░░░░░░
  58. ░░░░░░░░░░║ │Internal Code        GAMES                 ║░░░░░░░░░
  59. ░░░░░░░░░░║ │Access Requirements                     ║░░░░░░░░░
  60. ░░░░░░░░░░║ │Available Online Programs...                 ║░░░░░░░░░
  61. ░░░░░░░░░░╚══════════════════════════════════════════════════════════╝░░░░░░░░░
  62. ░░░░╔═══════════════════════════════════════════╗░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  63. ░░░░║           Online Program Sections        ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  64. ░░░░╠═══════════════════════════════════════════╣░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  65. ░░░░║ │Main                    ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  66. ░░░░║ │Games                    ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  67. ░░░░║ │                     ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  68. ░░░░╚═══════════════════════════════════════════╝░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  69.  
  70.     The Chess DOOR can be configured as given below.  Zchess uses only
  71.     DOOR.SYS drop files.  Also, Zchess was not developed with SBBS's XTRN
  72.     libraries.    As such, it has it's own communications routines.  You must
  73.     configure SBBS to NOT intercept I/O interrupts.  It is not essential to
  74.     force the system to change directories to Zchess, as Zchess will be
  75.     able to find all of its subdirectories based on the location of the
  76.     executable.  Zchess is always a multi-node chess door.  If your BBS is
  77.     multinodal, configure the Multiple Concurrent Users as YES.  If you
  78.     have only a single node version of Zchess, but have a multi-tasker
  79.     available and would like to play chess againt remote callers, you may
  80.     either run Zchess in a separate window using \ZCHESS\LOCAL.BAT.
  81.     Alternatively, you may share a session with a user while playing games
  82.     by pressing F6 after the user enteres a Game.
  83.  
  84. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  85. ░░░░╔═════╔══════════════════════════════════════════════════════════╗═════╗░░░
  86. ░░░░║  Ext║                 ZCHESS                 ║       ║░░░
  87. ░░░░╠═════╠══════════════════════════════════════════════════════════╣═════╣░░░
  88. ░░░░║ │Fix║ │Name            ZCHESS                 ║       ║░░░
  89. ░░░░║ │Tim║ │Internal Code        ZCHESS                 ║       ║░░░
  90. ░░░░║ │Glo║ │Start-up Directory     C:\ZCHESS             ║       ║░░░
  91. ░░░░║ │Ext║ │Command Line        ZCHESS %f             ║═════╝░░░
  92. ░░░░║ │Onl║ │Clean-up Command Line                     ║░░░░░░░░░
  93. ░░░░╚═════║ │Execution Cost        None                 ║░░░░░░░░░
  94. ░░░░░░░░░░║ │Access Requirements                     ║░░░░░░░░░
  95. ░░░░░░░░░░║ │Execution Requirements                     ║░░░░░░░░░
  96. ░░░░░░░░░░║ │Multiple Concurrent Users    Yes                 ║░░░░░░░░░
  97. ░░░░░░░░░░║ │Intercept I/O Interrupts    No                 ║░░░░░░░░░
  98. ░░░░░░░░░░║ │Swap BBS out of Memory    No                 ║░░░░░░░░░
  99. ░░░░╔═════║ │Modify User Data        No                 ║░░░░░░░░░
  100. ░░░░║      ║ │Execute on Event        No                 ║░░░░░░░░░
  101. ░░░░╠═════║ │BBS Drop File Type     (R) GAP        DOOR.SYS     ║░░░░░░░░░
  102. ░░░░║ │Mai║ │Place Drop File In     Node Directory             ║░░░░░░░░░
  103. ░░░░║ │Gam║ │Time Options...                         ║░░░░░░░░░
  104. ░░░░║ │   ╚══════════════════════════════════════════════════════════╝░░░░░░░░░
  105. ░░░░╚═══════════════════════════════════════════╝░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  106.  
  107.     The notifier provides a simple message is the user is active in chess
  108.     and has a move in one of his games.  Configuring zchess as a logon
  109.     event will remind players to visit the door.  If the user isn't active
  110.     in chess, or doesn't have a move, the notifier will be all but
  111.     invisible.
  112.  
  113. ░░░░╔═════╔══════════════════════════════════════════════════════════╗═════╗░░░
  114. ░░░░║  Ext║              ZCHESS NOTIFY              ║       ║░░░
  115. ░░░░╠═════╠══════════════════════════════════════════════════════════╣═════╣░░░
  116. ░░░░║ │Fix║ │Name            ZCHESS NOTIFY             ║       ║░░░
  117. ░░░░║ │Tim║ │Internal Code        ZCNOTIFY             ║       ║░░░
  118. ░░░░║ │Glo║ │Start-up Directory     C:\ZCHESS             ║       ║░░░
  119. ░░░░║ │Ext║ │Command Line        ZCHESS %f NOTIFY         ║═════╝░░░
  120. ░░░░║ │Onl║ │Clean-up Command Line                     ║░░░░░░░░░
  121. ░░░░╚═════║ │Execution Cost        None                 ║░░░░░░░░░
  122. ░░░░░░░░░░║ │Access Requirements                     ║░░░░░░░░░
  123. ░░░░░░░░░░║ │Execution Requirements                     ║░░░░░░░░░
  124. ░░░░░░░░░░║ │Multiple Concurrent Users    Yes                 ║░░░░░░░░░
  125. ░░░░░░░░░░║ │Intercept I/O Interrupts    No                 ║░░░░░░░░░
  126. ░░░░░░░░░░║ │Swap BBS out of Memory    No                 ║░░░░░░░░░
  127. ░░░░╔═════║ │Modify User Data        No                 ║░░░░░░░░░
  128. ░░░░║      ║ │Execute on Event        Logon                 ║░░░░░░░░░
  129. ░░░░╠═════║ │BBS Drop File Type     (R) GAP        DOOR.SYS     ║░░░░░░░░░
  130. ░░░░║ │Mai║ │Place Drop File In     Node Directory             ║░░░░░░░░░
  131. ░░░░║ │Gam║ │Time Options...                         ║░░░░░░░░░
  132. ░░░░║ │   ╚══════════════════════════════════════════════════════════╝░░░░░░░░░
  133. ░░░░╚═══════════════════════════════════════════╝░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  134.  
  135.     The example above allows the notifier to be run as an external program
  136.     as well.  If the Execute on Event flag is changed to Logon, Only, it
  137.     will not appear in the External programs menu.
  138.  
  139.     Note that for both the ZCHESS and the NOTIFIER, you want to try to run
  140.     without swapping the BBS out of Memory if at all possible.    This will
  141.     save some time when starting and exiting the door.    I am able to run
  142.     ZCHESS in a DesqView window with about 300K memory available.  If you
  143.     can't provide this much memory without swapping SBBS out, then you
  144.     don't have a choice.  You might wish to consider not using the notifier
  145.     in this case, as users often dislike unnecessary delays during login.
  146.  
  147.  
  148.  
  149.     Timed Maintenace Events
  150.  
  151.     NETCHESS and MAINT should be configured as timed events.  NETCHESS will
  152.     be available for version 2.0 and above.  Those registering Zchess 1.7
  153.     and above now will be allowed to Beta test NETCHESS now if they so
  154.     choose.
  155.  
  156. ░░░░╔═════════════════════╗░░░░╔═══════════════════════════════════════════╗░░░
  157. ░░░░║  External Programs  ║░░░░║        Timed Events           ║░░░
  158. ░░░░╠═════════════════════╣░░░░╠═══════════════════════════════════════════╣░░░
  159. ░░░░║ │Fixed Events      ║░░░░║ │MSGMAINT    %!smbutil mp500 *.shd ..\ma║░░░
  160. ░░░░║ │Timed Events      ║░░░░║ │ZCNETOUT    NETCHESS.EXE OUT       ║░░░
  161. ░░░░║ │Global Swap List   ║░░░░║ │ZCNETIN    NETCHESS.EXE IN        ║░░░
  162. ░░░░║ │External Editors   ║░░░░║ │ZCMAINT    MAINT.EXE           ║░░░
  163. ░░░░║ │Online Programs      ║░░░░╚═══════════════════════════════════════════╝░░░
  164. ░░░░╚═════════════════════╝░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  165. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  166.  
  167.     For this example NETCHESS.EXE is used twice in the Timed Events
  168.     list.  It can be configured for a single event by NOT adding the
  169.     commandline switches of OUT or IN.    Netchess, if not restricted,
  170.     with then do all of the processing for incomming messages, then all
  171.     of the processing for outgoing messages.  Its used twice here to
  172.     accomodate the following sequence of events:
  173.  
  174.     1.    NETCHESS OUT is called just after midnight, creating messages that
  175.     will be retrieved by BBSes calling in during the night.
  176.  
  177.     2.    BBSes call in between 2:00 AM and 5:00 AM, retrieve their messages
  178.     and post new ones.    The messages of course are created by ZCHESS, and
  179.     contain the  moves for the games.
  180.  
  181.     3.    NETCHESS IN is called after 6:00 AM.  Messages left by other BBSes
  182.     are found, and games are updated.  No new messages are created since
  183.     players have not yet had a chance to move.
  184.  
  185.     4.    MAINT.EXE is called after NETCHESS IN.    This performs any
  186.     maintenance required, rebuilds that data base, and keeps everything
  187.     fresh.
  188.  
  189.     Note that it might be propper to call netchess with no switches
  190.     instead of NETCHESS OUT.  Should there be any updates to games in the
  191.     database, it might prevent unnecessary game reporting.  This timing
  192.     depends on what BBSes call, act as a hub, the frequency of calls, etc.
  193.     so your configuration will likely be a bit different to optimize
  194.     communications.
  195.  
  196.  
  197. ░░░░╔═════════════════════╗░░░░╔═══════════════════════════════════════════╗░░░
  198. ░░░░║  External Programs  ║░░░░║        Timed Events           ║░░░
  199. ░░░░╠═════════════════════╣░░░░╠═══════════════════════════════════════════╣░░░
  200. ░░░░║ │Fixed Events      ║░░░░║ │MSGMAINT    %!smbutil mp500 *.shd ..\ma║░░░
  201. ░░░░║ │Timed Events      ║░░░░║ │ZCNETOUT    NETCHESS OUT           ║░░░
  202. ░░░░║ │Global Swap List   ║░░░░║ │ZCNETIN    NETCHESS IN           ║░░░
  203. ░░░░║ │External Editors   ║░░░░║ │ZCMAINT    MAINT.EXE           ║░░░
  204. ░░░░║ │Online Programs      ║░░░░╚═══════════════════════════════════════════╝░░░
  205. ░░░░╚═════════════════════╝░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  206. ░░░░░╔════════════════════════════════════════════════════════════════════╗░░░░
  207. ░░░░░║                  ZCNETOUT Timed Event              ║░░░░
  208. ░░░░░╠════════════════════════════════════════════════════════════════════╣░░░░
  209. ░░░░░║ │Internal Code            ZCNETOUT              ║░░░░
  210. ░░░░░║ │Start-up Directory        C:\ZCHESS              ║░░░░
  211. ░░░░░║ │Command Line            NETCHESS.EXE OUT          ║░░░░
  212. ░░░░░║ │Execution Node            1                  ║░░░░
  213. ░░░░░║ │Execution Days            Sun Mon Tue Wed Thu Fri Sat      ║░░░░
  214. ░░░░░║ │Execution Time            01:00                  ║░░░░
  215. ░░░░░║ │Requires Exclusive Execution    No                  ║░░░░
  216. ░░░░░║ │Force Users Off-line For Event    No                  ║░░░░
  217. ░░░░░╚════════════════════════════════════════════════════════════════════╝░░░░
  218.  
  219.     NETCHESS is started sometime after users stop calling in.  It is run
  220.     daily.  This configuration does not require exclusive access.  Note,
  221.     however, if you have a user on another node who is playing ZCHESS,
  222.     NETCHESS will pause this node until the user finishes, with a limit of
  223.     fifteen minutes.  If NETCHESS is not able to monopolize the ZCHESS
  224.     system ( including ZCHESS.EXE, MAINT.EXE and other copies of
  225.     NETCHESS.EXE), the output for that night will not be generated.  See
  226.     ZCHESS.DOC for information about how system monopolies are enforced.
  227.  
  228.  
  229.  
  230.